home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / man / Manuals / Omniclient / 5_Internet < prev    next >
Text File  |  1998-02-26  |  38KB  |  787 lines

  1. <HTML>
  2. <HEAD>
  3. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
  4. <TITLE> The Internet application</TITLE>
  5.  
  6. <META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.04z">
  7. </HEAD>
  8. <BODY BGCOLOR="#FFFFFF">
  9. <P>
  10. <A HREF="4_TCPintro"><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  11. <A HREF="Front"><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  12. <A HREF="TOC"><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  13. <A HREF="index"><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  14. <A HREF="6_filemap"><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  15. <P>
  16. <H1>5 The Internet application</H1>
  17. <HR>
  18. <P>
  19. This chapter tells you how to set an IP address. It also gives
  20. you information about a variety of modules and * commands that
  21. duplicate UNIX commands. If you're a more experienced Internet
  22. user you may well find these useful.
  23. <H2><A NAME="Set">Set</A>ting an IP address</H2>
  24. <P>
  25. The Internet application allows you to communicate with other
  26. computers on a fully-configured TCP/IP network. For this to work
  27. you need to use !InetSetup to reflect the state of your network,
  28. and your machine.
  29. <H3>Changing the setup </H3>
  30. <P>
  31. Firstly you must run !InetSetup and edit the displayed fields
  32. so that it specifies the machine (host) on the network to which
  33. it is connected.
  34. <P>
  35. A number of options are then displayed which you need to modify;
  36. the first one is Enable TCP/IP Protocol Suite. Choose this option
  37. and all the other options can now be accessed.
  38. <P>
  39. Choosing Interfaces should identify the network card in your machine
  40. and ticking the box will allow you to configure the options -
  41. for example, setting your IP address and the appropriate Netmask.
  42. <P>
  43. Routing allows you to select which host you will be using as a
  44. gateway, so that the computer knows how to access machines on
  45. other networks.
  46. <P>
  47. Host names requires your unique Host name to be entered, as well
  48. as server names and a choice of resolver modules if required,
  49. so that Internet names can be converted to IP numbers by a remote
  50. name server machine.
  51. <H3>Editing the hosts file</H3>
  52. <P>
  53. You will also need to edit the Hosts file - this can be done in
  54. Host names. This forms the link between the host name and the
  55. IP address (see <A HREF="4_TCPintro#plan">If you plan to connect to other sites…</A>
  56. for details of obtaining a unique IP address). The file has the
  57. following format:
  58. <P>
  59. <TT><FONT FACE="Courier">127.0.0.1 loopback localhost loghost
  60. <BR>
  61. 1.0.0.1 ahost <BR>
  62. 2.0.0.1 anotherhost<BR>
  63. 2.0.0.2 agateway<BR>
  64. 3.0.0.1 remotehost</FONT></TT>
  65. <P>
  66. You need to specify computers in this list to which software may
  67. need to refer to the remote computer by name. This may include
  68. server and gateway machines. Do not delete the loop-back entry.
  69. <H2><A NAME="Run">Run</A>ning the Internet application</H2>
  70. <P>
  71. To use any of these commands you need to run the Internet application.
  72. There are three ways you can do this:
  73. <UL>
  74. <LI>double-clicking on the Internet icon from the desktop
  75. <LI>typing a command at the command line
  76. <LI>including a command in a boot file.
  77. </UL>
  78. <P>
  79. In both the latter cases you must use a command of the form:
  80. <P>
  81. <TT><FONT FACE="Courier">*Run Internet_pathname.!Internet</FONT></TT>
  82. <P>
  83. where <TT><FONT FACE="Courier">Internet_pathname</FONT></TT> is
  84. the rest of the pathname to the Internet application. You <B>must</B>
  85. start the command with <TT><FONT FACE="Courier">*Run</FONT></TT>;
  86. if you don't RISC OS won't know which filing system holds the
  87. Internet application.
  88. <H3>Getting a <A NAME="command">command</A> line</H3>
  89. <P>
  90. If you're using the desktop, there are three ways of getting a
  91. command line so you can enter * Commands:
  92. <UL>
  93. <LI>Open a task window by pressing Ctrl-F12, or by choosing <B>Task
  94. window</B> from the Task Manager's icon bar menu.
  95. <LI>Temporarily leave the desktop by pressing F12, or by choosing
  96. <B>*Commands</B> from the Task Manager's icon bar menu.
  97. <LI>Permanently leave the desktop by choosing <B>Exit</B> from
  98. the Task Manager's icon bar menu.
  99. </UL>
  100. <H2>Internet <A NAME="mod">mod</A>ule * <A NAME="Commands">Commands</A>
  101. </H2>
  102. <P>
  103. The core of the Internet application is a module named Internet.
  104. It is stored as the !RunImage file within the application. It
  105. provides two * Commands:
  106. <P>
  107. <TABLE BORDER="1">
  108. <TR><TD WIDTH=140><B>Command </B></TD><TD WIDTH=378><B>Use </B>
  109. </TD></TR>
  110. <TR><TD WIDTH=140>*InetGateway</TD><TD WIDTH=378>Toggle IP packet forwarding 
  111. </TD></TR>
  112. <TR><TD WIDTH=140>*InetInfo</TD><TD WIDTH=378>Display Internet module internal statistics
  113. </TD></TR>
  114. </TABLE>
  115. <P>
  116. Running the Internet application loads the Internet module; you
  117. can then use the above * Commands.
  118. <H2><A NAME="Abs">Abs</A>olute programs</H2>
  119. <P>
  120. There are also a set of commands that are provided as Absolute
  121. files (i.e. each file is a program that performs one command)
  122. in the bin subdirectory of the Internet application. These are:
  123. <P>
  124. <TABLE BORDER="1">
  125. <TR><TD WIDTH=158><B>Command </B></TD><TD WIDTH=432><B>Use </B>
  126. </TD></TR>
  127. <TR><TD WIDTH=158>*ARP</TD><TD WIDTH=432>Address resolution display and control
  128. </TD></TR>
  129. <TR><TD WIDTH=158>*IfConfig</TD><TD WIDTH=432>Configure network interface parameters
  130. </TD></TR>
  131. <TR><TD WIDTH=158>*Ping</TD><TD WIDTH=432>Send ICMP ECHO_REQUEST packets to network hosts
  132. </TD></TR>
  133. <TR><TD WIDTH=158>*Route</TD><TD WIDTH=432>Manually manipulate the routing tables
  134. </TD></TR>
  135. </TABLE>
  136. <P>
  137. Running the Internet application adds the bin subdirectory to
  138. the system variable Run$Path. RISC OS then knows where to find
  139. the above * Commands, so you can use them directly from the command
  140. line.
  141. <P>
  142. Although the above are actually programs, in the section that
  143. follows we've treated them as * Commands because you're most likely
  144. to use them in just the same way.
  145. <H2>Ethernet <A NAME="driver">driver</A> module * Commands</H2>
  146. <P>
  147. The Ethernet driver modules (held in the drivers subdirectory
  148. of the application) each provide a single * Command to give information.
  149. <P>
  150. Ether3 refers to the A5000 style podules and EtherB to the Risc
  151. PC network card. Cards produced by different manufacturers may
  152. have differences - such as EtherH (i-cubed) - but all are suitable.
  153. <P>
  154. The Ether3 module also provides a configuration command:
  155. <P>
  156. <TABLE BORDER="1">
  157. <TR><TD WIDTH=149><B>Command </B></TD><TD WIDTH=441><B>Use </B>
  158. </TD></TR>
  159. <TR><TD WIDTH=149>*Configure Ether3</TD><TD WIDTH=441>Sets the configured state 
  160. </TD></TR>
  161. <TR><TD WIDTH=149>*Configure EtherB</TD><TD WIDTH=441>of Acorn Ethernet 3 cards
  162. </TD></TR>
  163. <TR><TD WIDTH=149>*EnInfo</TD><TD WIDTH=441>Display details of physical interface activity, including their physical addresses 
  164. </TD></TR>
  165. </TABLE>
  166. <P>
  167. Running the Internet application loads any appropriate Ethernet
  168. driver modules; you can then use any of the above * Commands that
  169. are relevant to your interface(s).
  170. <HR>
  171. <H2>*ARP<A NAME="arp"></A></H2>
  172. <HR>
  173. <P>
  174. Address resolution display and control
  175. <H3>Syntax</H3>
  176. <P>
  177. <TT><FONT FACE="Courier">*ARP <I>host<BR>
  178. </I>*ARP -a<BR>
  179. *ARP -d <I>host<BR>
  180. </I>*ARP -s <I>host</I> <I>phys_addr</I> [temp] [pub]<BR>
  181. *ARP -f <I>filename</I></FONT></TT>
  182. <H3>Parameters</H3>
  183. <H3><TT><I><FONT SIZE=2 FACE="Courier">host</FONT></I></TT><FONT SIZE=4 FACE="Arial">
  184. </FONT></H3>
  185. <P>
  186. an Internet host specified either by name (which must be present
  187. in the host name data base <InetDBase$Path>hosts) or by
  188. address (using the standard Internet dot notation)
  189. <H3><TT><I><FONT SIZE=2 FACE="Courier">phys_addr</FONT></I><FONT SIZE=4 FACE="Courier">
  190. </FONT></TT></H3>
  191. <P>
  192. the physical address of host given in Ethernet format (i.e. six
  193. hexadecimal bytes separated by colons)
  194. <H3><TT><I><FONT SIZE=2 FACE="Courier">filename</FONT></I></TT><FONT SIZE=4 FACE="Arial">
  195. </FONT></H3>
  196. <P>
  197. the full pathname of a file containing multiple entries to be
  198. set in the ARP table
  199. <H3>Use</H3>
  200. <P>
  201. The ARP program displays and modifies the Internet-to-Physical-address
  202. translation tables located in the Internet module and used by
  203. the address resolution protocol ARP.
  204. <P>
  205. With no flags, the program displays the current ARP entry for
  206. host.
  207. <P>
  208. The -a flag makes the program display all the ARP entries currently
  209. in its table. 
  210. <P>
  211. The -d flag makes the program delete an entry for host.
  212. <P>
  213. The -s flag makes the program create an ARP entry for the host
  214. called host with the physical address phys_addr.
  215. <UL>
  216. <LI>The entry will be permanent unless the word temp is given
  217. in the command.
  218. <LI>The entry will be `published' if the word pub is given. This
  219. system will then act as an ARP or Reverse ARP server, responding
  220. to requests for host's physical address even though the host address
  221. is not its own.
  222. </UL>
  223. <P>
  224. The -f flag causes the file filename to be read and multiple entries
  225. to be set in the ARP tables. Entries in the file should be of
  226. the form:
  227. <P>
  228. <TT><FONT FACE="Courier">host phys_addr [temp] [pub]</FONT></TT>
  229. <P>
  230. with argument meanings as given above.
  231. <P>
  232. If you don't know the physical address of an interface, you can
  233. use the *InetInfo command to find it.
  234. <P>
  235. For your reference, the physical address of an Econet interface
  236. takes the form:
  237. <P>
  238. <TT><FONT FACE="Courier">00.00.00.00.<I>station_number</I>.<I>net_number</I></FONT></TT>
  239. <H3>Examples</H3>
  240. <P>
  241. <TT><FONT FACE="Courier">*ARP tp1<BR>
  242. *ARP -a<BR>
  243. *ARP -d 01.01.01.01<BR>
  244. *ARP -s tp1 01.01.01.01.01.01 temp<BR>
  245. *ARP -f adfs::HardDisc.$.Internet.ARP_Table</FONT></TT>
  246. <H3>Related commands</H3>
  247. <P>
  248. None
  249. <HR>
  250. <H2>*Configure Ether3/<A NAME="confether">EtherB</A></H2>
  251. <HR>
  252. <P>
  253. Sets the configured state of Acorn Ethernet 3 cards
  254. <H3>Syntax</H3>
  255. <P>
  256. <TT><FONT FACE="Courier">*Configure Ether3 Enable|Disable|Default|Terse|Verbose
  257. [<I>card</I></FONT></TT><FONT SIZE=2>]</FONT>
  258. <H3>Parameters</H3>
  259. <P>
  260. <TT><I><FONT SIZE=2 FACE="Courier">card </FONT></I></TT> the expansion
  261. card's number, as given by *Podules
  262. <H3>Use</H3>
  263. <P>
  264. *Configure Ether3 sets the configured state of all fitted Acorn
  265. Ethernet 3 cards, or of a single card specified by its expansion
  266. card slot number.
  267. <P>
  268. *Configure Ether3 Enable permits the interface to be used - which
  269. is the default - whereas *Configure Ether3 Disable prevents the
  270. interface from being used.
  271. <P>
  272. *Configure Ether3 Default sets the configured state to the default:
  273. namely, Enabled.
  274. <H3>Example</H3>
  275. <P>
  276. <TT><FONT FACE="Courier">*Configure Ether3 Default 0</FONT></TT> 
  277. <H3>Related commands</H3>
  278. <P>
  279. <A HREF="#status">*Status Ether3/EtherB</A>
  280. <HR>
  281. <H2>*E<I>n<A NAME="eninfo">Info</A></I></H2>
  282. <HR>
  283. <P>
  284. Display details of physical interface activity, including their
  285. physical addresses
  286. <H3>Syntax</H3>
  287. <P>
  288. <TT><FONT FACE="Courier">*E1Info </FONT></TT> Display details for
  289. all Acorn Ethernet 1 cards
  290. <P>
  291. <TT><FONT FACE="Courier">*E2Info </FONT></TT> Display details for
  292. all Acorn Ethernet 2 cards
  293. <P>
  294. <TT><FONT FACE="Courier">*E3Info </FONT></TT> Display details for
  295. all Ethernet 3 cards
  296. <P>
  297. <TT><FONT FACE="Courier">*EBInfo </FONT></TT> Display details for
  298. all Atomwide-based Network slot cards
  299. <P>
  300. <TT><FONT FACE="Courier">*EHInfo </FONT></TT> Display details for
  301. all i-cubed (I3) cards
  302. <H3>Use</H3>
  303. <P>
  304. *E<I>n</I>Info displays details of physical interface activity,
  305. including the physical addresses of all Ethernet interfaces of
  306. the relevant type that are fitted to the computer.
  307. <P>
  308. Most of the information displayed is runic in nature. It is presented
  309. mainly as an aid to trouble-shooting, should you require it.
  310. <P>
  311. If you are using an interface that is not listed above, you should
  312. consult its documentation to see if its manufacturer has provided
  313. a similar command; we expect most will do so.
  314. <H3>Example</H3>
  315. <P>
  316. <TT><B><FONT SIZE=2 FACE="Courier">*E3Info</FONT></B></TT> 
  317. <P>
  318. <TT><FONT SIZE=2 FACE="Courier">Ether3 interface statistics
  319. <BR>
  320. ea0: 8005 16 bit MEMC1a, slot 2, up, hardware address 00:02:07:00:A3:48
  321. <BR>
  322. Interface driver : ea <BR>
  323. Interface unit : 0 <BR>
  324. Interface location : Expansion slot 2 <BR>
  325. Interface address : 00:02:07:00:A3:48 <BR>
  326. Interface controller: 8005 16 bit MEMC1a <BR>
  327. Initialise time : Wed Mar 1 11:32:02 1995 <BR>
  328. Running time : 2 minutes, 5 seconds. <BR>
  329. Packets sent : 4362<BR>
  330. Packets received : 4830<BR>
  331. Bytes sent : 2276647<BR>
  332. Bytes received : 2352828<BR>
  333. Send errors : <BR>
  334. Receive errors : <BR>
  335. Broadcasts sent : <BR>
  336. Broadcasts received : 298<BR>
  337. <BR>
  338. Multicasts sent : <BR>
  339. Multicasts received : 111<BR>
  340. Monitor sends : <BR>
  341. Monitor receives : <BR>
  342. Send interrupts : 4362<BR>
  343. Receive interrupts : 4830<BR>
  344. Delivered packets : 4835<BR>
  345. Undelivered packets : <BR>
  346. Sends too large : <BR>
  347. Send max collisions : <BR>
  348. Send overflows : <BR>
  349. Sends blocked : <BR>
  350. Receives too small : <BR>
  351. Receives too large : <BR>
  352. Incomplete receives : <BR>
  353. Receive CRC errors : <BR>
  354. Lack of mbufs : <BR>
  355. Receive overflows : <BR>
  356. Standard clients:<BR>
  357. Frame = &0800, ErrLvl=00, AddrLvl=01<BR>
  358. Frame = &0806, ErrLvl=00, AddrLvl=01<BR>
  359. Frame = &8035, ErrLvl=00, AddrLvl=01<BR>
  360. IEEE 802.3 client:<BR>
  361. Frame = &0000, ErrLvl=00, AddrLvl=02<BR>
  362. Log: Ether3 messages can appear here</FONT></TT> 
  363. <H2>Related commands</H2>
  364. <P>
  365. *<A HREF="#Info" >InetInfo</A>
  366. <HR>
  367. <H2>*<A NAME="If">If</A>Config</H2>
  368. <HR>
  369. <P>
  370. Configure network interface parameters
  371. <H3>Syntax</H3>
  372. <P>
  373. <TT><FONT FACE="Courier">*IfConfig <I>interface</I> <I>address_family</I>
  374. [<I>address</I> [<I>dest_address</I>]] [parameters] </FONT></TT> 
  375. <P>
  376. <TT><FONT FACE="Courier">*IfConfig <I>interface</I> [<I>protocol_family</I>]
  377. </FONT></TT> 
  378. <P>
  379. <TT><FONT FACE="Courier">*IfConfig -a </FONT></TT> 
  380. <P>
  381. <TT><FONT FACE="Courier">*IfConfig -au </FONT></TT> 
  382. <P>
  383. <TT><FONT FACE="Courier">*IfConfig -ad</FONT></TT> 
  384. <H3>Parameters </H3>
  385. <P>
  386. <TABLE >
  387. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=151><TT><I><FONT SIZE=2 FACE="Courier">address</FONT></I></TT> 
  388. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=586>for the DARPA-Internet family, the address is either a host name present in the host name data base, hosts, or a DARPA Internet address expressed in the Internet standard dot notation. For the Xerox Network SystemsTM family, addresses are net:a.b.c.d.e.f, where net is the assigned network number (in decimal), and each of the six bytes of the host number, a through f, are specified in hexadecimal. The host number may be omitted on 10Mb/s Ethernet interfaces, which use the hardware physical address, and on interfaces other than the first. For the ISO family, addresses are specified as a long hexadecimal string, as in the Xerox family. However, two consecutive dots imply a zero byte, and the dots are optional, if the user wishes to count out long strings of digits in network byte order.
  389. </TD></TR>
  390. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=151><TT><I><FONT SIZE=2 FACE="Courier">address_family</FONT></I></TT> 
  391. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=586>Specifies the address family which affects interpretation of the remaining parameters. Since an interface can receive transmissions in differing protocols with different naming schemes, specifying the address family is recommended. The address or protocol families currently supported are inet, iso, and ns.
  392. </TD></TR>
  393. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=151><TT><I><FONT SIZE=2 FACE="Courier">interface</FONT></I></TT> 
  394. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=586>The interface parameter is a string of the form name unit, for example, en0.
  395. </TD></TR>
  396. </TABLE>
  397. <H3>Use </H3>
  398. <P>
  399. IfConfig is used to assign an address to a network interface and/or
  400. configure network interface parameters. IfConfig must be used
  401. at boot time to define the network address of each interface present
  402. on a machine; it may also be used at a later time to redefine
  403. an interface's address or other operating parameters.
  404. <P>
  405. You can set the following parameters with the IfConfig program:
  406. <P>
  407. <TABLE >
  408. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">alias</FONT></TT> 
  409. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Establish an additional network address for this interface. This is sometimes useful when changing network numbers, and one wishes to accept packets addressed to the old interface.
  410. </TD></TR>
  411. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">arp</FONT></TT> 
  412. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Enable the use of the Address Resolution Protocol in mapping between network level addresses and link level addresses (default). This is currently implemented for mapping between DARPA Internet addresses and 10Mb/s Ethernet addresses.
  413. </TD></TR>
  414. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">-arp</FONT></TT> 
  415. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Disable the use of the Address Resolution Protocol
  416. </TD></TR>
  417. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">broadcast (Inet only)</FONT></TT> 
  418. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Specify the address to use to represent broadcasts to the network. The default broadcast address is the address with a host part of all 1's.
  419. </TD></TR>
  420. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">debug</FONT></TT> 
  421. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Enable driver-dependant debugging code; usually this turns on extra console error logging.
  422. </TD></TR>
  423. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">delete</FONT></TT> 
  424. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Remove the network address specified. This would be used if you incorrectly specified an alias, or it was no longer needed. If you have incorrectly set an NS address having the side effect of specifying the host portion, removing all NS addresses will allow you to respecify the host portion.
  425. </TD></TR>
  426. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">dest_address</FONT></TT> 
  427. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Specify the address of the correspondent on the other end of a point to point link.
  428. </TD></TR>
  429. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">down</FONT></TT> 
  430. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Mark an interface `down'. When an interface is marked `down', the system will not attempt to transmit messages through that interface. If possible, the interface will be reset to disable reception as well. This action does not automatically disable routes using the interface.
  431. </TD></TR>
  432. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">ipdst</FONT></TT> 
  433. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>This is used to specify an Internet host which is willing to receive ip packets encapsulating NS packets bound for a remote network. An apparent point-to-point link is constructed, and the address specified will be taken as the NS address and network of the destination. IP encapsulation of CLNP packets is done differently.
  434. </TD></TR>
  435. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">metric n</FONT></TT> 
  436. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Set the routing metric of the interface to n, default 0. The routing metric is used by the routing protocol routed. Higher metrics have the effect of making a route less favourable; metrics are counted as addition hops to the destination network or host.
  437. </TD></TR>
  438. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">mtu n</FONT></TT> 
  439. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Set the maximum transmission unit of the interface to n; the default is interface-specific. The mtu is used to limit the size of packets that are transmitted on an interface. Not all interfaces support setting the mtu, and some interfaces have range restrictions.
  440. </TD></TR>
  441. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">netmask mask</FONT></TT> 
  442. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>(Inet and ISO) : specify how much of the address to reserve for subdividing networks into sub-networks. The mask includes the network part of the local address and the subnet part, which is taken from the host field of the address. The mask can be specified as a single hexadecimal number with a leading 0x, with a dot-notation Internet address, or with a pseudo-network name listed in the network table networks. The mask contains 1's for the bit positions in the 32-bit address which are to be used for the network and subnet parts, and 0's for the host part. The mask should contain at least the standard network portion, and the subnet field should be contiguous with the networkportion.
  443. </TD></TR>
  444. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">nsellength n</FONT></TT> 
  445. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>This specifies a trailing number of bytes for a received NSAP used for local identification, the remaining leading part of which is taken to be the NET (Network Entity Title). The default value is 1, which is conformant to US GOSIP. When an ISO address is set in an IfConfig command, it is really the NSAP which is being specified. For example, in US GOSIP, 20 hex digits should be specified in the ISO NSAP to be assigned to the interface. There is some evidence that a number different from 1 may be useful for AFI 37 type addresses.
  446. </TD></TR>
  447. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">trailers</FONT></TT> 
  448. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Request the use of a `trailer' link level encapsulation when sending (default). If a network interface supports trailers, the system will, when possible, encapsulate outgoing messages in a manner which minimizes the number of memory to memory copy operations performed by the receiver. On networks that support the Address Resolution Protocol (see <A HREF="#arp">ARP</A>; currently, only 10 Mb/s Ethernet), this flag indicates that the system should request that other systems use trailers when sending to this host. Similarly, trailer encapsulations will be sent to other hosts that have made such requests. Currently used by Internet protocols only.
  449. </TD></TR>
  450. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">-trailers</FONT></TT> 
  451. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Disable the use of a `trailer' link level encapsulation.
  452. </TD></TR>
  453. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">link[0-2]</FONT></TT> 
  454. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Enable special processing of the link level of the interface. These three options are interface specific in actual effect, however, they are in general used to select special modes of operation. An example of this is to enable SLIP compression. Currently, only used by SLIP.
  455. </TD></TR>
  456. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">-link[0-2]</FONT></TT> 
  457. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Disable special processing at the link level with the specified interface.
  458. </TD></TR>
  459. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">up</FONT></TT> 
  460. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Mark an interface `up'. This may be used to enable an interface after an IfConfig down. It happens automatically when setting the first address on an interface. If the interface was reset when previously marked down, the hardware will be re-initialized
  461. </TD></TR>
  462. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">IfConfig -a</FONT></TT> 
  463. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>This displays information on all interfaces. When followed by a configuration parameter, it will also set the configuration on all interfaces.
  464. </TD></TR>
  465. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=150><TT><FONT FACE="Courier">IfConfig -au</FONT></TT> 
  466. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=606>Similar to IfConfig -a, except it only affects interfaces that are currently marked as up. Conversely, IfConfig -ad affects only interfaces that are marked down. IfConfig displays the current configuration for a network interface when no optional parameters are supplied. If a protocol family is specified, IfConfig will report only the details specific to that protocol family. Only the super-user may modify the configuration of a network interface.
  467. </TD></TR>
  468. </TABLE>
  469. <H3>Example </H3>
  470. <P>
  471. <TT><FONT FACE="Courier">*IfConfig ea0 inet tp1 up</FONT></TT> 
  472. <H3>Related Commands </H3>
  473. <P>
  474. None
  475. <HR>
  476. <H2>*Inet<A NAME="Gate">Gate</A>way</H2>
  477. <HR>
  478. <P>
  479. Toggle IP packet forwarding
  480. <H3>Syntax</H3>
  481. <P>
  482. <TT><FONT FACE="Courier">*InetGateway 1|0</FONT></TT> 
  483. <H3>Use</H3>
  484. <P>
  485. *InetGateway may be used to enable (*InetGateway 1) or to disable
  486. (*InetGateway 0) IP layer packet forwarding (i.e. gateway operation)
  487. if multiple network interfaces are present.
  488. <P>
  489. The default state is off.
  490. <H3>Example</H3>
  491. <P>
  492. <TT><FONT FACE="Courier">*InetGateway 1</FONT></TT> 
  493. <H3>Related commands</H3>
  494. <P>
  495. None
  496. <HR>
  497. <H2>*Inet<A NAME="Info">Info</A></H2>
  498. <HR>
  499. <P>
  500. Display Internet module internal statistics
  501. <H3>Syntax</H3>
  502. <P>
  503. <TT><FONT FACE="Courier">*InetInfo [r][i]</FONT></TT> 
  504. <H3>Use</H3>
  505. <P>
  506. *InetInfo displays detailed information about Internet module
  507. activity. By default it only gives details of internal resource
  508. usage and protocol activity using the options
  509. <P>
  510. <TABLE >
  511. <TR><TD WIDTH=38><TT><FONT FACE="Courier">r</FONT></TT> </TD><TD WIDTH=531>display only internal resource information (the default)
  512. </TD></TR>
  513. <TR><TD WIDTH=38><TT><FONT FACE="Courier">i</FONT></TT> </TD><TD WIDTH=531>display only interface information
  514. </TD></TR>
  515. </TABLE>
  516. <P>
  517. Most of the information displayed is runic in nature. It is presented
  518. mainly as an aid to trouble-shooting, should you require it.
  519. <P>
  520. The i option used in Release 1 of the TCP/IP Protocol Suite to
  521. give information on an interface has been replaced by the *EnInfo
  522. command.
  523. <H3>Example</H3>
  524. <P>
  525. <TT><FONT FACE="Courier">*InetInfo rp</FONT></TT> 
  526. <H3>Related commands</H3>
  527. <P>
  528. *<A HREF="#eninfo">EnInfo</A>
  529. <HR>
  530. <H2>*<A NAME="Ping">Ping</A></H2>
  531. <HR>
  532. <P>
  533. Send ICMP ECHO_REQUEST packets to network hosts
  534. <H3>Syntax</H3>
  535. <P>
  536. <TT><FONT FACE="Courier">*Ping [-dfnqrvR] [-c <I>count</I>] [-i
  537. <I>wait</I>] [-l <I>preload</I>] [-p <I>pattern</I>] [-s <I>packetsize</I>]</FONT></TT> 
  538. <H3>Parameters </H3>
  539. <P>
  540. <TABLE >
  541. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=132><TT><FONT FACE="Courier">-c <I>count</I></FONT></TT> 
  542. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=595>stop after sending and receiving count ECHO_RESPONSE packets.
  543. </TD></TR>
  544. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=132><TT><FONT FACE="Courier">-i <I>wait</I></FONT></TT> 
  545. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=595>wait within seconds between sending each packet. The default is to wait for one second between each packet. This option is incompatible with the -f option.
  546. </TD></TR>
  547. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=132><TT><FONT FACE="Courier">-l <I>preload</I></FONT></TT> 
  548. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=595>if preload is specified, ping sends that many packets as fast as possible before falling into its normal mode of behaviour
  549. </TD></TR>
  550. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=132><TT><FONT FACE="Courier">-p <I>pattern</I></FONT></TT> 
  551. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=595>you may specify up to 16 `pad' bytes to fill out the packet you send. This is useful for diagnosing data-dependent problems in a network. For example -p ff will cause the sent packet to be filled with all ones.
  552. </TD></TR>
  553. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=132><TT><FONT FACE="Courier">-s <I>packetsize</I></FONT></TT> 
  554. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=595>specifies the number of data bytes to be sent. The default is 56, which translate into 64 ICMP data bytes when combined with the 8 bytes of ICMP header data.
  555. </TD></TR>
  556. </TABLE>
  557. <H2>Use </H2>
  558. <P>
  559. An Internet can be a large and complex aggregation of network
  560. hardware, connected together by gateways. Tracking a single-point
  561. hardware or software failure can be difficult. The Ping program
  562. utilises the ICMP protocol's mandatory ECHO_REQUEST datagram to
  563. elicit an ICMP ECHO_RESPONSE from a host or gateway. ECHO_REQUEST
  564. datagrams (or pings have an IP and ICMP header, and then an arbitrary
  565. number of padding bytes used to fill out the packet.
  566. <P>
  567. The optional -d parameter sets the SO_DEBUG option on the socket
  568. being used. The optional -f parameter causes a flood ping. It
  569. outputs packets as fast as they come back or one hundred times
  570. per second, whichever is more. For every ECHO_REQUEST sent a period
  571. `.' is printed, while for every ECHO_REPLY received a backspace
  572. is printed. Providing a rapid display of the number of packets
  573. dropped, but only a super-user may use this option and can be
  574. hard on a network. 
  575. <P>
  576. The optional -n parameter specifies numeric output only. No attempt
  577. will be made to look up symbolic names for host addresses.
  578. <P>
  579. The optional -q parameter specifies quiet output. Nothing is displayed
  580. except the summary lines at start-up time and when finished.
  581. <P>
  582. The optional -r parameter bypasses the normal routing tables and
  583. sends directly to a host on an attached network. If the host is
  584. not on a directly-attached network, an error is returned. This
  585. option can be used to ping a local host through an interface that
  586. has no route through it (e.g. after the interface was dropped
  587. by routed).
  588. <P>
  589. The optional -v parameter specifies verbose output. ICMP packets
  590. other than ECHO_RESPONSE that are received are listed. The optional
  591. -R parameter specifies the recording of the route. Includes the
  592. RECORD_ROUTE option in the ECHO_REQUEST packet and displays the
  593. route buffer on returned packets. Note that the IP header is only
  594. large enough for nine such routes. Many hosts ignore or discard
  595. this option.
  596. <P>
  597. When using ping for fault isolation, it should first be run on
  598. the local host, to verify that the local network interface is
  599. up and running. Then, hosts and gateways further and further away
  600. should be `pinged'. 
  601. <H3>ICMP packet details </H3>
  602. <P>
  603. An IP header without options is 20 bytes. An ICMP ECHO_REQUEST
  604. packet contains an additional eight bytes worth of ICMP header
  605. followed by some data. When a packetsize is given, this indicated
  606. the size of this extra piece of data (default is 56). The amount
  607. of data received inside of an IP packet of type ICMP ECHO_REPLY
  608. will always be eight bytes more than the requested data space
  609. (the ICMP header).
  610. <P>
  611. If the data space is at least eight bytes large, ping uses the
  612. first eight bytes of this space to include a timestamp which it
  613. uses in the computation of round trip times. If less than eight
  614. bytes of pad are specified, no round trip times are given.
  615. <H3>Duplicate and damaged packets </H3>
  616. <P>
  617. Ping will report duplicate and damaged packets. Duplicate packets
  618. should never occur, and seem to be caused by inappropriate link-level
  619. retransmissions. Duplicates may occur in many situations and are
  620. rarely (if ever) a good sign, although the presence of low levels
  621. of duplicates may not always be cause for alarm.
  622. <P>
  623. Damaged packets are obviously serious cause for alarm and often
  624. indicate broken hardware somewhere in the ping packet's path (in
  625. the network or in the hosts).
  626. <H3>Trying different data patterns </H3>
  627. <P>
  628. The (inter)network layer should never treat packets differently
  629. depending on the data contained in the data portion. However,
  630. data-dependent problems can get into networks and remain undetected.
  631. In many cases the pattern that will have problems is something
  632. that doesn't have sufficient `transitions', such as all ones or
  633. all zeros. It's not usually enough to specify a data pattern of
  634. all zeros on the command line because the pattern of interest
  635. is at the data link level, and the relationship between what you
  636. type and what the controllers transmit can be complicated.
  637. <P>
  638. This means that if you have a data-dependent problem you will
  639. probably have to do a lot of testing to find it. If you are lucky,
  640. you may manage to find a file that either can't be sent across
  641. your network or that takes longer to transfer than other similar
  642. size files. Then test using -p option of Ping examine for file
  643. repeated patterns.
  644. <H3>Example </H3>
  645. <P>
  646. <TT><FONT FACE="Courier">*Ping -v tp1 1024 20</FONT></TT> 
  647. <H3>Related Commands </H3>
  648. <P>
  649. None
  650. <HR>
  651. <H2>*<A NAME="Route">Route</A></H2>
  652. <HR>
  653. <P>
  654. Manually manipulate the routing tables
  655. <H3>Syntax </H3>
  656. <P>
  657. <TT><FONT FACE="Courier">*Route [-e] [-n] [-v] [-q] add | delete
  658. | change | get | monitor | flush [-net | -host] <I>destination</I>
  659. <I>gateway flags</I> </FONT></TT> 
  660. <P>
  661. <TT><FONT FACE="Courier">*Route [-e] [-n] [-v] [-q] flush | monitor</FONT></TT> 
  662. <H3>Parameters </H3>
  663. <P>
  664. <TABLE >
  665. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142><TT><I><FONT SIZE=2 FACE="Courier">destination</FONT></I></TT> 
  666. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=558>an Internet hot or network specified either by name (which must be present in the respective host or network name data base <InetDBase$Path>...) or by address (using the standard Internet dot notation)
  667. </TD></TR>
  668. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142><TT><I><FONT SIZE=2 FACE="Courier">gateway</FONT></I></TT> 
  669. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=558>the next hop gateway to which packets should be addressed
  670. </TD></TR>
  671. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=142><TT><I><FONT SIZE=2 FACE="Courier">flags</FONT></I></TT> 
  672. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=558>various commands used to manipulate the routing
  673. </TD></TR>
  674. </TABLE>
  675. <H3>Use </H3>
  676. <P>
  677. You can use the Route program manually to manipulate the Internet
  678. module's network routing tables.
  679. <P>
  680. Routes to a particular host are distinguished from those to a
  681. network by interpreting the Internet address associated with the
  682. destination. The optional keywords net and host force the destination
  683. to be interpreted as a network or a host, respectively. Otherwise,
  684. if the destination has a local address part of 0 or if there is
  685. a symbolic name of a network, the route's presumed to be a host.
  686. All symbolic names specified from a destination or a gateway are
  687. looked up first as a host name; if this fails, the name is then
  688. looked up as a network name.
  689. <P>
  690. The -e option makes Route place any fatal error report string
  691. in the system variable Inet$Error instead of writing it to the
  692. standard output.
  693. <P>
  694. The -n option bypasses attempts to print host and network names
  695. symbolically when reporting actions. However, translating between
  696. symbolic names and numerical equivalents can be time consuming
  697. and may require correct operation of the network.
  698. <P>
  699. The -v option (verbose) allows the printing of additional details.
  700. <P>
  701. The -q option allows the suppression of all output.
  702. <P>
  703. There are many flags which can be attached to the routing command
  704. line and they are as follows:
  705. <P>
  706. <TABLE >
  707. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-cloning</FONT></TT> 
  708. </TD><TD WIDTH=539>generates a new route on use</TD></TR>
  709. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-iface</FONT></TT> 
  710. </TD><TD WIDTH=539>destination is directly reachable</TD></TR>
  711. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-static</FONT></TT> 
  712. </TD><TD WIDTH=539>is a manually added route</TD></TR>
  713. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-nostatic</FONT></TT> 
  714. </TD><TD WIDTH=539>is a pretended route added by kernel or daemon
  715. </TD></TR>
  716. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-reject</FONT></TT> 
  717. </TD><TD WIDTH=539>to emit an ICMP unreachable when matched</TD>
  718. </TR>
  719. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-blackhole</FONT></TT> 
  720. </TD><TD WIDTH=539>silently discards packets during updates</TD>
  721. </TR>
  722. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-rtt n</FONT></TT> 
  723. </TD><TD WIDTH=539>shows initial round-trip time</TD></TR>
  724. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-rttvar n</FONT></TT> 
  725. </TD><TD WIDTH=539>shows initial RTT variance</TD></TR>
  726. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-mtu n</FONT></TT> 
  727. </TD><TD WIDTH=539>shows initial MTU</TD></TR>
  728. <TR><TD WIDTH=132><TT><FONT FACE="Courier">-expire n</FONT></TT> 
  729. </TD><TD WIDTH=539>shown expiry time</TD></TR>
  730. </TABLE>
  731. <H3>Examples </H3>
  732. <P>
  733. <TT><FONT FACE="Courier">*Route -n monitor</FONT></TT> 
  734. <H3>Related Commands </H3>
  735. <P>
  736. None
  737. <HR>
  738. <H2>*<A NAME="OLE_LINK2">Status</A> Ether3/<A NAME="status">EtherB</A>
  739. </H2>
  740. <HR>
  741. <P>
  742. Displays the configured state of Acorn Ethernet 3 cards
  743. <H3>Syntax</H3>
  744. <P>
  745. <TT><FONT FACE="Courier">*Status Ether3</FONT></TT> 
  746. <H3>Use</H3>
  747. <P>
  748. *Status Ether3 displays the configured state of all fitted Acorn
  749. Ethernet 3 cards.
  750. <H3>Example</H3>
  751. <P>
  752. <TT><B><FONT FACE="Courier">*Status Ether3</FONT></B></TT> 
  753. <P>
  754. <TT><FONT FACE="Courier">ether3 enabled 0</FONT></TT> 
  755. <H2>Related commands</H2>
  756. <P>
  757. <A HREF="#confether">*Configure Ether3</A>
  758. <HR>
  759. <H2>*Status EtherH</H2>
  760. <HR>
  761. <P>
  762. Displays the configured state of Acorn Ethernet H cards
  763. <H3>Syntax</H3>
  764. <P>
  765. <TT><FONT FACE="Courier">*Status EtherH</FONT></TT> 
  766. <H3>Use</H3>
  767. <P>
  768. *Status EtherH displays the configured state of all fitted Acorn
  769. Ethernet H cards.
  770. <H3>Example</H3>
  771. <P>
  772. <TT><B><FONT /TT>  FACE="Courier">*Status EtherH</FONT></B></TT> 
  773. <P>
  774. <TT><FONT FACE="Courier">etherH virtual on</FONT></TT> 
  775. <H3>Related commands</H3>
  776. <P>
  777. <A HREF="#confether">*Configure Ether</A>
  778. <P>
  779. <A HREF="4_TCPintro"><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  780. <A HREF="Front"><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  781. <A HREF="TOC"><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  782. <A HREF="index"><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  783. <A HREF="6_filemap"><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  784. <P>
  785. </BODY>
  786. </HTML>
  787.